home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 7 / zcomd289.zip / ZCOMMDOC.AB < prev    next >
Text File  |  1989-02-23  |  73KB  |  1,801 lines
  1.  
  2.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  3.         ZCOMM User Manual                                                   31
  4.  
  5.  
  6.         8.  YOUR TELEPHONE DIRECTORY
  7.  
  8.         ZCOMM's telephone directory is a big flexibility advantage over
  9.         traditional communications programs which require one or more separate
  10.         files for each system called, or limit directory information to little
  11.         more than a telephone number.
  12.  
  13.         The telephone directory is a plain ASCII text file which can be edited
  14.         with standard text editors (brief, teco, EMACS, edlin, etc.).
  15.         Normally, ZCOMM expects to find the telephone directory in the file
  16.         /PHODIR.t on the current disk.  The pathname may be changed with the
  17.         DOS environment variable PHONES.  Forward slashes should be used to
  18.         indicate directories.
  19.  
  20.         EXAMPLE: C>set PHONES=c:/yam/lib/PHODIR.t
  21.  
  22.  
  23.         The putsnp program may also be used to change ZCOMM's default, as
  24.         described above.
  25.  
  26.         The call command is normally used to make a connection with another
  27.         computer.  When you give a call name command, ZCOMM prepares for a
  28.         modem call and then searches the telephone directory file for a line
  29.         starting with name.
  30.  
  31.         It is not necessary to type the entire name as it appears in the file.
  32.         ZCOMM will find the first entry that name is a prefix of.
  33.  
  34.         EXAMPLE: call cis would access either the cis300 or cis1200 telephone
  35.         directory entry, whichever was first.
  36.  
  37.         When using two entries with similar names (such as "cis300" and
  38.         "cis1200"), place the favorite entry first.  This way you can just
  39.         type call cis to get the desired entry.
  40.  
  41.         If the search is successful, the call command copies the complete
  42.         directory entry name to the remote string parameter, where it can be
  43.         used for log entries and automatic password generation.  ZCOMM
  44.         executes the commands on the rest of the line (if any), and on
  45.         succeeding lines beginning with a space or tab.
  46.  
  47.         There is no arbitrary limit to the size of the telephone directory.
  48.         Popular entries may be placed near the front to minimize searching
  49.         time.  Scripts can also be placed in separate files when desired.
  50.  
  51.         8.1  Customizing Your Telephone Directory
  52.  
  53.         Your next step is to edit the distribution PHODIR.t to suit your
  54.         needs.
  55.  
  56.         When ZCOMM begins execution, it searches the telephone directory for
  57.  
  58.  
  59.         (C) 1988 Omen Tech Inc              Chapter 8 Your Telephone Directory
  60.  
  61.  
  62.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  63.         ZCOMM User Manual                                                   32
  64.  
  65.  
  66.         the setup entry.  (A directory entry has the entry name starting at
  67.         the left margin.)
  68.  
  69.  
  70.         The setup telephone directory in the distributed phodir.t file invokes
  71.         a demonstration menu.  Once you have exercized the various
  72.         demonstration possibilities, search for the xsetup telephone directory
  73.         and change it to setup be removing the "x".  This will blank out the
  74.         oroginal setup entry which appears later in the file.
  75.  
  76.         setup     port 1
  77.  
  78.         The first line of the "setup" entry selects port 1.
  79.  
  80.              : if !c speed 1200 putw "ATZ\r"
  81.  
  82.         This line is commented out with a colon (:).  If the colon is removed,
  83.         the speed is changed to 1200 and ZCOMM sends an initialization command
  84.         to the modem if no carrier detect signal is present.  If a carrier
  85.         detect signal is present (modem still connected to the remote
  86.         computer), the speed is not changed, and no initialization command is
  87.         sent to the modem.
  88.  
  89.              pd1; pz480
  90.  
  91.         enables incoming time/date information provided by the ZMODEM and True
  92.         YMODEM protocols.  Time/date stamping of transmitted files provides
  93.         many advantages over traditional protocols, including the ability to
  94.         selectively transmit files if the source file is newer than receiver's
  95.         copy.  The number in the pz480 command should represent the local time
  96.         zone expressed as minutes behind GMT.[1]
  97.  
  98.         This line should be commented out with a leading colon (or removed) if
  99.         you use a backup program that depends on the dates of files to
  100.         determine which to save.
  101.  
  102.              set mprefix "ATDP"
  103.  
  104.         sets the string parameter mprefix to ATDP, setting the Hayes modem to
  105.         use rotary (pulse) dialing.  If your phone uses tone dialing, comment
  106.         that line out (place a leading colon to make ZCOMM pass over it) and
  107.         uncomment the line containig "ATDT".
  108.  
  109.              set l "1"; set m "1"
  110.  
  111.  
  112.  
  113.         __________
  114.  
  115.          1. Pacific Standard Time is 480 minutes behind Greenwich Mean Time
  116.  
  117.  
  118.  
  119.         (C) 1988 Omen Tech Inc              Chapter 8 Your Telephone Directory
  120.  
  121.  
  122.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  123.         ZCOMM User Manual                                                   33
  124.  
  125.  
  126.         The l and m string parameters support the dynamic selection of one or
  127.         more ALDS alternate long distance carriers.  The default values for
  128.         these parameters is the digit 1.
  129.  
  130.         When making entries in your telephone directory, use %l- for numbers
  131.         with different area codes, and %m- for numbers with the same area code
  132.         as yours.
  133.  
  134.         The set command sets the string parameter l (lower case L) to 1
  135.         (number), providing for normal long distance access.  If you have an
  136.         alternative long distance service, set this parameter to the required
  137.         access string for that service.[2] The "set m 1" command sets the
  138.         string parameter m to 1, providing for normal long distance access for
  139.         numbers in your same area code.  If you have an alternative long
  140.         distance service, set this parameter to the required access string for
  141.         that service, plus your area code if required. (Some alternate long
  142.         distance services require the area code for all calls, even those in
  143.         your own area code.)
  144.  
  145.              set answerback "YOUR NAME CITY\r\n\21"
  146.  
  147.         Change the answerback setting to reflect your name.[3] Be sure to keep
  148.         the \21 at the end of the string.[4]
  149.  
  150.         The next lines configure soft keys F3 to FS4.  Their functions are
  151.         described at the end of Chapter 15.
  152.  
  153.              : display bell=visual
  154.  
  155.         Causes bell characters to be displayed as a non spacing flashing
  156.         musical note instead of sounding.  If you want a silent bell,
  157.         uncomment this line.
  158.  
  159.              set quitcmd "\003\336off\r"
  160.  
  161.         This string is sent to the remote before disconnecting when an ALT-Q
  162.         is typed during a protocol file transfer.
  163.  
  164.              : set calllog c:/calllog
  165.              : set rxlog c:/tmp/rxlog
  166.              : set txlog c:/tmp/txlog
  167.  
  168.  
  169.         __________
  170.  
  171.          2. Use the "setsavenet" entry in PHODIR.t as a prototype.
  172.  
  173.          3. Some timesharing systems may require a specific answerback string.
  174.  
  175.          4. See Chapter 23 for a description character escapes.
  176.  
  177.  
  178.  
  179.         (C) 1988 Omen Tech Inc              Chapter 8 Your Telephone Directory
  180.  
  181.  
  182.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  183.         ZCOMM User Manual                                                   34
  184.  
  185.  
  186.         The above lines set the pathnames for logs of calls, files received,
  187.         and files transmitted.  The above log file entries must be commented
  188.         out for use with ZCOMM.
  189.  
  190.              set f10 "@help"
  191.              if fyamhelp.t set helpfile "yamhelp.t"
  192.              if f/umanh.hlp set helpfile "@yhp /umanh.hlp"
  193.              if fumanh.hlp set helpfile "@yhp umanh.hlp"
  194.  
  195.         The above lines locate the help file and program F10 to summon the
  196.         help processor if available.  These lines may be changed if you keep
  197.         these files in other directories.
  198.  
  199.              : if dc ps4 pn2 pr97
  200.  
  201.         If a color display is used, these colors may be more suitable than the
  202.         default black and white.  Uncommenting this line selects red status
  203.         line (ps4), green normal text (pn2), and a blue/yellow for reverse
  204.         video (pr97).  Another possibility is "pn3" which selects blue-green
  205.         for normal text.  You may wish to experiment with these values to find
  206.         ones best suited for your particular combination of display equipment
  207.         and visual preferences.  Changing the colors from time to time may
  208.         prolong display tube life.  The colors Telephone Directory entry
  209.         displays the colors generated by the possible numeric parameter
  210.         values:
  211.  
  212.         EXAMPLE: gosub colors
  213.  
  214.         Some programs, including the "DEC Store" demonstration, will not
  215.         display exactly as intended with some combinations of the above
  216.         display parameters.
  217.  
  218.         If you use a long distance credit card or sometimes dial out from
  219.         hotel or PBX lines, be sure to modify the att, ddd, hotel9, and hotel8
  220.         telephone directory entries to suit your needs.
  221.  
  222.         You may wish to keep your phone numbers etc.  in one file and relegate
  223.         information specific to each computer to a separate file.  The setup
  224.         entry checks for the existience of a PHONES.TS file and executes it of
  225.         found.
  226.  
  227.              set s0 ""
  228.              setc pho "%PHONES\&s";  if f%pho source %pho
  229.              if %s0 return
  230.  
  231.         The supplied PHONES.TS file is used on Omen's 386 Xenix system, and
  232.         may be used as an example.  If you use VT100 emulation with keyboard
  233.         mapping most of the time, you can add the contents of the keyboard
  234.         mapping file MK.STD or MK.101 to your PHONES.TS file.
  235.  
  236.         While editing your telephone directory, you might wish to add some
  237.  
  238.  
  239.         (C) 1988 Omen Tech Inc              Chapter 8 Your Telephone Directory
  240.  
  241.  
  242.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  243.         ZCOMM User Manual                                                   35
  244.  
  245.  
  246.         entries for your favorite systems in the same format used by the
  247.         "amrad", "amsat", or "denver" directory entries.
  248.  
  249.         When the PHODIR.t file is ready, type "ZCOMM<ENTER>" to run ZCOMM.
  250.         ZCOMM will print several lines of greeting and then silently execute
  251.         the commands in the "setup" directory entry.
  252.  
  253.         If ZCOMM can't open PHODIR.t, exit ZCOMM with "x<ENTER>" and copy
  254.         PHODIR.t to the correct directory, or set the DOS PHONES environment
  255.         variable to the actual pathname (see Chapter 14).  Also check that the
  256.         DOS CONFIG.SYS files contains FILES=20 to allow ZCOMM a sufficient
  257.         number of open files for proper script operation.  If using DOS 3.x,
  258.         you will need to have a STACKS line in your CONFIG.SYS file, as
  259.         described in Chapter 26.
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.         (C) 1988 Omen Tech Inc                 Chapter 8 Tutorial Introduction
  300.  
  301.  
  302.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  303.         ZCOMM User Manual                                                   36
  304.  
  305.  
  306.         9.  HANDS ON TUTORIAL
  307.  
  308.         As a first order of business, run the demonstration program by typing
  309.         ZCOMMDEMO at the DOS prompt.  The demo asks certain questions about
  310.         your system, and then allows you to exercise a few of ZCOMM's features
  311.         from a menu.  It's a good way to get a first "feel" for ZCOMM before
  312.         getting down to business with the industrial strength software you
  313.         will be using.
  314.  
  315.         Remember to turn off the CAPS LOCK key when running ZCOMM.
  316.  
  317.         ASSUMPTIONS: In addition to the minimum hardware requirements for
  318.         ZCOMM, this tutorial assumes the use of a Hayes Smartmodem 1200 (or
  319.         equivalent) connected to the COM1 port in accordance with the
  320.         instructions in Chapter 7.  The tutorial assumes that ZCOMM.EXE,
  321.         YHP.EXE, UMANH.HLP, and PHODIR.t are copied to the root directory of
  322.         your working disk, and that ZCOMM.EXE has been serialized with the
  323.         putsnp program.  If your system configuration is different, you will
  324.         have to read the manual carefully to learn how to adjust for your
  325.         configuration.
  326.  
  327.         After typing ZCOMM from the DOS prompt to load ZCOMM, type F10 to
  328.         activate the flash-up help processor.  Browse through it briefly to
  329.         familiarize yourself with the information available via the F10 help
  330.         key.
  331.  
  332.         To make a call without using a directory entry, type speed 1200 (or
  333.         whatever) and then the phone number:
  334.  
  335.         speed 1200 123-4567
  336.  
  337.         The modem then dials the number.  When you are connected, ZCOMM will
  338.         return to its command prompt.  Keyboard F2 to begin talking with the
  339.         remote.  Give some commands to the remote until several screens' worth
  340.         of text have scrolled by.
  341.  
  342.         Now press the PgUp function key.  The screen will now display text
  343.         that had scrolled off before.  Use the PgUp, Home, PgDn, and End
  344.         function keys to move around in the review buffer.
  345.  
  346.         Look for a moderately interesting nugget of wisdom, and use the up
  347.         arrow and down arrow function keys on the numeric keypad to place the
  348.         interesting part at the top of the screen.
  349.  
  350.         Hit "t" to set the top marker.  This causes all the text to display in
  351.         high intensity.  Now move down using the down arrow key to place the
  352.         first line of unwanted text at the top of the screen.
  353.  
  354.         Hit the "b" key to set the bottom pointer.  This will change the
  355.         displayed text back to normal intensity.
  356.  
  357.  
  358.  
  359.         (C) 1988 Omen Tech Inc                 Chapter 9 Tutorial Introduction
  360.  
  361.  
  362.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  363.         ZCOMM User Manual                                                   37
  364.  
  365.  
  366.         Now hit "w" and ZCOMM will prompt for a filename to write the selected
  367.         text to.  Type the filename followed by <ENTER>, and ZCOMM will write
  368.         the selected data.  When the write operation is finished, the screen
  369.         will redisplay the text.
  370.  
  371.         When you have the feel of it, type F1 to return to the term function
  372.         and conversational connection to the remote computer.
  373.  
  374.         The demonstration disk circular buffer search/cut/paste menu choice
  375.         demonstrates many of the review subcommands.
  376.  
  377.         Next, log off the remote computer.  When it drops the line, ZCOMM
  378.         displays "No Carrier Detect Signal" in reverse video to announce that
  379.         the connection has been lost.  At this time you are still in the term
  380.         function.
  381.  
  382.         When you return to ZCOMM's command prompt (by typing F1), type
  383.         "off<ENTER>" to disconnect the modem and exit back to DOS.
  384.  
  385.         Now is a good time to read the rest of the manual to discover the
  386.         power of ZCOMM.  Chapter 9 presents some unusual sessions
  387.         demonstrating more of ZCOMM's capabilities.
  388.  
  389.         9.1  Sample Sessions
  390.  
  391.                           Direct connection to COM2 at 19kb
  392.  
  393.          unix  port 2 speed 19200 source mk.101; t
  394.           |         |         |      |
  395.           |         |         | Map keyboard, Invoke term function
  396.           |         |         ___ Set 19200 bits per second
  397.           |         ______________ Select port COM2
  398.           _________________________ System name
  399.  
  400.                                 Typical bulletin board
  401.  
  402.          rcpm   port 1 speed 1200 123-4567 t -8g
  403.           |         |      |         |     |
  404.           |         |      |         |     _ Term function, graphics
  405.           |         |      |         _______ Number to call
  406.           |         |      __________________ 1200 baud
  407.           |         _________________________ Select COM1
  408.           ____________________________________ System name
  409.  
  410.                                A Not so Typical Session
  411.  
  412.         The example below assumes a Hayes modem connected to a radio receiver
  413.         tuned to the W1AW ASCII bulletins.  Refer to a recent issue of QST
  414.         Magazine for a W1AW schedule.  to select the best signal.  Usually,
  415.         the error rate is lowest when receiving a strong signal near the
  416.         Maximum Useable Frequency (MUF).  Set the radio for Upper Sideband
  417.  
  418.  
  419.         (C) 1988 Omen Tech Inc                       Chapter 9 Sample Sessions
  420.  
  421.  
  422.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  423.         ZCOMM User Manual                                                   38
  424.  
  425.  
  426.         (USB) reception.  Tune it so the resulting audio frequencies make the
  427.         RD (Received Data) light turn on about 50 percent of the time.  Reset
  428.         the modem by powering it down before attempting regular calls.
  429.  
  430.         w1aw speed 110 putw "ATS10=255 C0 H2 D\r" t -v
  431.                  |                  |                |
  432.                  |                  |        -v prints control chars
  433.                  |                  |        as ^C so they won't
  434.                  |                  |        erase the screen, etc.
  435.                  |   Ignore Carrier Detect, Carrier Off, Special Off
  436.                  |   Hook (Don't close relay), Originate, Online
  437.                  |________ W1AW ASCII transmissions are at 110 bps
  438.  
  439.         A>ZCOMM call unix   Connect to a local system named unix
  440.         jabber jabber ...   Login to system, change directory
  441.         <ALT-2>Command:     Get a ZCOMM command prompt
  442.         sz prg?.? prghlp.mm Upload some files
  443.         jabber jabber ...
  444.         sz *.c *.h          Download some source files
  445.         Receiving ...       ZMODEM AutoDownload accepts them
  446.         kermit -ix          Start the Unix Kermit server
  447.         <F1>>>>c:           Get ZCOMM's command prompt
  448.         remote dir          Get a directory listing
  449.         Directory...        Directory listing on screen
  450.         get f2              Get (fetch) a file
  451.         f2 Open ...         File arrives
  452.         send myfile         Send myfile to server
  453.         finish              Finish server access
  454.         t                   Enter term function
  455.         kermit send f1      Start a Kermit file transfer
  456.         f1 Open...          File is received AUTOMAGICALLY!
  457.         jabber jabber ...   Log off local system
  458.         <F1>>>>c:           Get ZCOMM's command prompt
  459.         port 1              Select modem on COM1
  460.         call rcpm           Dial a system called "rcpm"
  461.         jabber jabber ...   Keyboarding with remote
  462.         <Home>              Review function at top of text
  463.         /to superhacker     Search for beginning of message to you
  464.         t                   Set top pointer
  465.         /to j. fred muggs   Search for beginning of next message
  466.         b                   Set bottom pointer
  467.         w                   Write selected text to a disk file
  468.         <F1>                Return to term function
  469.         E<ENTER>            Tell the rcpm to enter a message
  470.         <ALT-2>Command:     Get a ZCOMM command prompt
  471.         open -p letter      Open "letter" and send to bbs, using
  472.                             prompt and throttle modes to slow
  473.                             transmission so the remote system won't
  474.                             drop characters.
  475.         dir                 Find out what files are on the RCPM
  476.         xmodem s foo.bqr    Command RCPM to download a file
  477.  
  478.  
  479.         (C) 1988 Omen Tech Inc                       Chapter 9 Sample Sessions
  480.  
  481.  
  482.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  483.         ZCOMM User Manual                                                   39
  484.  
  485.  
  486.         <ALT-2>Command:     Get a ZCOMM command prompt
  487.         rc foo.bqr          Download a file with XMODEM/CRC
  488.         PgUp PgUp ...       Flip back to the first part of
  489.                             directory previously listed
  490.         <ENTER>             Back to term function
  491.         xmodem s dr.who     Download a critical file
  492.         <ALT-2>Command:     Get a ZCOMM command prompt
  493.         rc \misc\dr.who     Download the file
  494.         jabber jabber ...   More keyboarding, logoff
  495.         <F1>>>>c:           Get ZCOMM's command prompt
  496.          Connect the modem to the radio's audio and tune in W1AW
  497.         create rtty.tmp     Create a disk file for the bulletins
  498.         call w1aw
  499.         bleep twort sneep   Static on the radio - pure line hits until
  500.                             W1AW is received while sending ASCII
  501.         <F2>k               Review/k command clears the buffer
  502.         QST DE W1AW ...
  503.         END ... AR
  504.         <ALT-C>             Close the capture file
  505.         <F1>>>>c:off        Return to DOS
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.         (C) 1988 Omen Tech Inc            Chapter 9 Accessing Computer Systems
  540.  
  541.  
  542.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  543.         ZCOMM User Manual                                                   40
  544.  
  545.  
  546.         10.  ACCESSING COMPUTER SYSTEMS
  547.  
  548.         10.1  Dialing
  549.  
  550.         Once you modem is interfaced per Chapter 7, you can connect to a
  551.         remote system with the call command referencing an entry in your
  552.         telephone directory entry.
  553.  
  554.         EXAMPLE: call kgbvax
  555.  
  556.  
  557.         If a telephone directory entry has not been set up, TurboLearn(TM) may
  558.         be invoked to dial a phone number and then learn your login procedure
  559.         by keyboarding the F4 key.  You may choose to add the resulting script
  560.         to your telephone directory, or retain it as a separate file acessible
  561.         with the source command.  Please refer to the learn command in Chapter
  562.         15.
  563.  
  564.         If you just want to call a number without ZCOMM learing anything, type
  565.         the telephone number from the command prompt already.[1]
  566.  
  567.         EXAMPLE: 123-4567
  568.  
  569.         When the modem connects, ZCOMM returns to the command prompt.  You can
  570.         then keyboard the F2 key to connect your keyboard to the remote
  571.         system.  If you wish to use "bulletin board graphics", keyboard t -8g
  572.         instead.
  573.  
  574.         10.2  Telenet/PC-Pursuit
  575.  
  576.         For best results, identify with D1 when Telenet asks for your terminal
  577.         type.  This selection prevents the network from adding padding
  578.         characters, which are just a waste of time with ZCOMM.
  579.  
  580.         To use XMODEM, YMODEM, Telink, and other traditional protocols on PC
  581.         Pursuit, give the Telenet command
  582.  
  583.         SET 1:0,4:2,5:0,7:8,12:0
  584.  
  585.         after connecting to the PC-Pursuit target city.  This command prevents
  586.         Telenet from "eating" control characters or breaking the connection
  587.         when files containing certain patterns are transmitted.  This command
  588.         disables Telenet's "<ENTER>@<ENTER>" escape.
  589.  
  590.         To use ZMODEM or Kermit Sliding Windows give the command:
  591.  
  592.  
  593.         __________
  594.  
  595.          1. You may wish to add the /mnp modifier described in Chapter 7.
  596.  
  597.  
  598.  
  599.         (C) 1988 Omen Tech Inc           Chapter 10 Accessing Computer Systems
  600.  
  601.  
  602.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  603.         ZCOMM User Manual                                                   41
  604.  
  605.  
  606.         SET 4:2,5:1,12:1
  607.  
  608.         instead.
  609.  
  610.         Please refer to Chapter 13 for network flow control considerations.
  611.  
  612.         10.3  Tymnet
  613.  
  614.         If using Tymnet, type Ctrl-R Ctrl-X just before the host computer name
  615.         to enable flow control with XOFF and XON.  "Half Duplex" may be
  616.         activated with Ctrl-H.  Check with your network's documentation for
  617.         further details or updates to this information.
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.         (C) 1988 Omen Tech Inc                           Chapter 10 File Names
  660.  
  661.  
  662.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  663.         ZCOMM User Manual                                                   42
  664.  
  665.  
  666.         11.  FILE NAMES Good and Bad
  667.  
  668.         The pathnames of downloaded files must be legal PC-DOS file names as
  669.         described in The File Specification in chapter 2 of the PC-DOS manual.
  670.         When choosing file names, remember that PC-DOS does not distinguish
  671.         between uppercase and lowercase characters in pathnames.
  672.  
  673.         The Compuserve-B, ZMODEM, YMODEM, and Kermit protocols use pathnames
  674.         generated by the sending program.  File names transmitted from other
  675.         systems may not be legal for DOS, or they may reference directories
  676.         that cannot be created.[1]
  677.  
  678.         When ZCOMM receives a pathname from the sending program, ZCOMM first
  679.         checks for the existence of a file with the same name.  If no such
  680.         file is found, ZCOMM attempts to open the named file for writing.
  681.         Missing directories are generated automatically.  A pathname that
  682.         cannot be opened for reading or writing is considered illegal.
  683.  
  684.         EXAMPLE: foo..bar is illegal for DOS because it contains two dots.
  685.  
  686.         An Illegal pathname is translated to name.NNN where name is the
  687.         filename portion of the given file name restricted to 8 characters,
  688.         and NNN is an assigned three digit number starting with 001 and
  689.         incremented after each file download.  If a file with this new name
  690.         already exists, the number is incremented up to 999, until a unique
  691.         file name is found.  The open fails if a unique number cannot be
  692.         found.
  693.  
  694.         EXAMPLE: A downloaded file with the name newprog.patch.1 might
  695.         actually be downloaded as newprog.001.
  696.  
  697.         This check for illegal file names is made whenever ZCOMM attempts to
  698.         create an output file.
  699.  
  700.         EXAMPLE: t foo.bar.baz given from the command prompt would invoke file
  701.         name translation.
  702.  
  703.  
  704.         11.1  Pathname Translations
  705.  
  706.         Files affected by the dirrx and dircx string variables have their
  707.         directory paths and/or device specifier stripped if the string
  708.         variable ends in a "/".  Otherwise a file specification with an
  709.         absolute path overrides the string variable.  The pathname of the
  710.  
  711.  
  712.         __________
  713.  
  714.          1. A cirectory cannot be created if a regular file with the same
  715.             pathname is present.
  716.  
  717.  
  718.  
  719.         (C) 1988 Omen Tech Inc                           Chapter 11 File Names
  720.  
  721.  
  722.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  723.         ZCOMM User Manual                                                   43
  724.  
  725.  
  726.         incoming file is checked before any of these transformations, allowing
  727.         a host system to place all files received with a protocol in a private
  728.         directory.
  729.  
  730.         EXAMPLE: C>set DIRRX=C:/download
  731.         places files received with a protocol in the download directory on
  732.         drive C unless the file specification included an absolute path or
  733.         device letter.
  734.  
  735.         dirrx     File Stored Location
  736.         (empty)   any  (same)
  737.         C:/a f    C:/a/f
  738.         C:/a /f   /f
  739.         C:/a A:f  A:f
  740.         C:/a/     f    C:/a/f
  741.         C:/a/     /f   C:/a/f
  742.         C:/a/     A:f  C:/a/f
  743.  
  744.  
  745.         SV   Affected commands
  746.         dirrx     r{bcotwx7}, fget, get, bdump, usq, ZMODEM/Kermit
  747.         AutoDownload
  748.         dirsx     s{bctx7}, send, B protocol sends[2]
  749.         dircx     create, t, message, private, >, bro/a
  750.                   review/w, ap[d] (2nd argument)
  751.         dirfx     f, open
  752.  
  753.         To show the possible pathname translations, consider the pathmame:
  754.         A:/spy/kgb/sabotage/666 sent between two copies of ZCOMM with the
  755.         ZMODEM protocol.
  756.  
  757.         The sending program command:      sz A:/spy/kgb/sabotage/666 sends the
  758.         file name 666.
  759.  
  760.         The command      sz -f A:/spy/kgb/sabotage/666 sends the complete
  761.         pathname /spy/kgb/sabotage/666.
  762.  
  763.         The command      sz ONAME=hogwash A:/spy/kgb/sabotage/666 sends the
  764.         pathname hogwash.
  765.  
  766.              sz PREFIX=C:/fbi/security/intelligence A:/spy/kgb/sabotage/666
  767.         sends the pathname C:/fbi/security/intelligence/666.  Note that a disk
  768.         identifier (C:) is being sent.
  769.  
  770.  
  771.  
  772.         __________
  773.  
  774.          2. If the dirsx parameter is set, ambiguous or wild card file names
  775.             cannot be used.
  776.  
  777.  
  778.  
  779.         (C) 1988 Omen Tech Inc                           Chapter 11 File Names
  780.  
  781.  
  782.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  783.         ZCOMM User Manual                                                   44
  784.  
  785.  
  786.         On reception with ZMODEM AutoDownload or the rz command, the last
  787.         example (C:/fbi/security/intelligence/666) would normally be stored
  788.         under that exact pathname, creating the directories C:/fbi,
  789.         C:/fbi/security, and C:/fbi/security/intelligence if needed.
  790.  
  791.         If the dirrx string variable had contained C:/downloads the incoming
  792.         drive specifier would still have overidden the dirrx specification.
  793.  
  794.         If the dirrx string variable had contained C:/ollie/to_do/ the file
  795.         would have ended up as C:/ollie/to_do/666 to the consternation of all.
  796.  
  797.         The command      rz foobar could have been used to rename this file to
  798.         foobar in the current directory.
  799.  
  800.         The oncloserx and onclosetx string parameters may be used to specify
  801.         commands to execute after each file received or sent with file
  802.         transfer protocols.  Their use is described in Chapter 11.
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.         (C) 1988 Omen Tech Inc              Chapter 11 Protocol File Transfers
  840.  
  841.  
  842.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  843.         ZCOMM User Manual                                                   45
  844.  
  845.  
  846.         12.  PROTOCOL FILE TRANSFERS
  847.  
  848.         With many different ways to transfer files with ZCOMM, your choice of
  849.         file transfer methods could make the difference between efficient,
  850.         error free data and slow or error prone transfers.  This chapter gives
  851.         an overview of the different ways to transfer files with emphasis on
  852.         their relative merits.
  853.  
  854.         A file transfer protocol should have high integrity (assurance of
  855.         accurate data) and high robustness (low probability of aborting a
  856.         transfer).  When the file transfer is attended, robustness is not so
  857.         critical because the transfer can be restarted.
  858.  
  859.         The following subchapters discuss these file transfer methods in more
  860.         detail.
  861.  
  862.         12.1  ZMODEM
  863.  
  864.         ZMODEM was developed for the public domain under contract by Telenet,
  865.         a major packet switched network.  ZMODEM has been submitted to the
  866.         ANSI X12C committee.
  867.  
  868.         ZMODEM provides a greatly simplified user interface.  The file name is
  869.         entered once, and transfer options may be given to the sending
  870.         program, even those that apply to the receiver.  ZMODEM
  871.         AutoDownload(TM) allows menu and mouse driven programs to download
  872.         files and commands with no extra keyboarding required.
  873.  
  874.         ZMODEM transfers one or more files with a single command.  The size
  875.         and transfer time for each file is displayed, and the total number of
  876.         files, size, and transmission time is displayed when more than one
  877.         file remains to be sent on a command.
  878.  
  879.         Keyboarding ALT-F allows the receiver to bypass an individual file
  880.         without having to restart the batch.
  881.  
  882.         ZMODEM transfers both files and commands.  Command download allows one
  883.         of the computers to take positive control of the session.  A security
  884.         challenge (activated by ZMODEM AutoDownload(TM)) guards against Trojan
  885.         Horse messages.*
  886.  
  887.         ZMODEM file transfers preserve the file date[1] and the exact file
  888.         contents, unlike traditional protocols that append garbage to files.
  889.  
  890.         In a sense, ZMODEM is four file transfer protocols in one.  Streaming
  891.  
  892.  
  893.         __________
  894.  
  895.          1. Controlled by the d and z numeric parameters
  896.  
  897.  
  898.  
  899.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  900.  
  901.  
  902.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  903.         ZCOMM User Manual                                                   46
  904.  
  905.  
  906.         transmission provides full throughput over satellite links and packet
  907.         switched networks.  One of three ZMODEM streaming control methods may
  908.         be used with systems that allow the sender to monitor the received
  909.         data for error correction packets without interrupting transmission.
  910.         Individually acknowledged packets support other systems.
  911.  
  912.         ZMODEM allows programs to adjust the protocol parameters for optimum
  913.         efficiency as the file is being sent.
  914.  
  915.         Some programs support ZMODEM compression for even faster file
  916.         transfers under appropriate conditions with the Z file transfer
  917.         option.
  918.  
  919.         ZMODEM is immune to most of the error conditions that prevent accurate
  920.         file transfers with traditional protocols.
  921.  
  922.          + ZMODEM data transfers are protected by the Federal Standard 32 bit
  923.            CRC to assure reliable transfers.  This 32 bit CRC gives an
  924.            undetected error rate five orders of magnitude better than XMODEM's
  925.            16 bit CRC, and more than a billion times better than checksum
  926.            XMODEM.  ZMODEM uses 16 bit CRC for file transfers with programs
  927.            that do not support 32 bit CRC.
  928.  
  929.          + Most important, all ZMODEM protocol transactions are protected by
  930.            CRC.  Competing protocols advertising 16 or 32 bit CRC sometimes
  931.            fail under stress because critical control messages are not
  932.            protected by CRC.
  933.  
  934.         ZMODEM supports Intelligent Crash Recovery(TM) and advanced file
  935.         management.  If you've ever been disconnected when a huge file
  936.         transfer was almost finished, you'll appreciate resuming/recovering
  937.         the file transfer with the ZMODEM r option.
  938.  
  939.         You can use the ZMODEM n option to transfer only those files that have
  940.         changed since the last time they were transferred.  With the p option,
  941.         you can unconditionally protect files that already exist on the
  942.         destination system.  To update only the files you already have while
  943.         skipping the rest, use the Yn options.
  944.  
  945.         To send a file with ZMODEM, the command sz file1 can be given from
  946.         either the main command prompt, or from the term function via a
  947.         secondary command prompt obtained with ALT-2.  Multiple files and wild
  948.         cards may be used.
  949.  
  950.         EXAMPLE: sz file1 file2 *.lst
  951.  
  952.  
  953.         12.1.1  ZMODEM AutoDownload  If Z mode has been enabled (the default),
  954.         ZCOMM's term function will detect a ZMODEM transmission and receive
  955.         the file(s) automatically, after a security check.  File transfer
  956.         options for ZMODEM automatic downloads may be specified with the
  957.  
  958.  
  959.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  960.  
  961.  
  962.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  963.         ZCOMM User Manual                                                   47
  964.  
  965.  
  966.         adlopts string parameter.
  967.  
  968.         The rz command may be also given from a command prompt.
  969.  
  970.         Please refer to the sz and zcommand commands described in Chapter 15
  971.         for examples and information.
  972.  
  973.         Rz and sz programs for Unix and VAX/VMS are available in rzsz.zoo.
  974.  
  975.         12.1.2  Tuning ZMODEM Parameters  Chapter 21.2 describes a number of
  976.         ZMODEM numeric parameters which may be adjusted for extraordinary
  977.         situations, or to fine tune the last 0.1 per cent of possible
  978.         performance.
  979.  
  980.         The ZMODEM subpacket length (zmodem L parameter) and the ZMODEM frame
  981.         length (zmodem l parameter) deserve special mention.  People tend to
  982.         confuse these with the familiar 128 and 1024 byte block length used in
  983.         XMODEM transfers.
  984.  
  985.         When a ZMODEM frame length of 0 is specified (the default), a single
  986.         frame will span the entire file if there are no errors.  This is the
  987.         main source of ZMODEM's reputation for fast transfers.
  988.  
  989.         Setting the ZMODEM frame length to a number between 64 and 16384
  990.         restricts the frame length to that value.  At the end of each frame,
  991.         the sender stops sending and waits for an acknowledgement from the
  992.         receiver.  When set, the ZMODEM frame length corresponds in function
  993.         to the 128 or 1024 byte block length of XMODEM based protocols.
  994.  
  995.         Each ZMODEM frame consists of one or more subpackets of 32 to 1024
  996.         bytes.  Since the subpackets within a frame are sent without pause, a
  997.         short subpacket length does not exact the terrible throughput penalty
  998.         associated with short XMODEM and Kermit blocks.  In the absence of
  999.         transmission errors, a 256 byte subpacket length has about two per
  1000.         cent more overhead than a 1024 byte subpacket length.  However, the
  1001.         longer subpacket length does increase error recovery time.
  1002.  
  1003.         ZCOMM dynamically adjusts the ZMODEM subpacket length on the basis of
  1004.         transmission speed and observed error rate.  If you know what the
  1005.         error rate on a particular call will be before starting a ZMODEM file
  1006.         transfer, setting the zmodem L numeric parameter will provide a small
  1007.         but noticeable improvement in performance, with 1024 best for clean
  1008.         lines and smaller numbers better for noisy lines.
  1009.  
  1010.         When sending files over noisy phone lines not involving networks, the
  1011.         speed of error recovery may be increased by decreasing the values of
  1012.         the ZMODEM t and p numeric parameters.
  1013.  
  1014.         Fascinating information about ZMODEM and other protocols is provided
  1015.         in ymodem.doc and zmodem.doc, part of yzmodem.zoo (yzmodem.arc).
  1016.  
  1017.  
  1018.  
  1019.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1020.  
  1021.  
  1022.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1023.         ZCOMM User Manual                                                   48
  1024.  
  1025.  
  1026.         12.1.3  Manual ABORT  If for some reason a ZMODEM transfer fails,[2]
  1027.         the program on the remote machine may be manually terminated by
  1028.         repeatedly typing Ctrl-X characters at it until the program exits.
  1029.  
  1030.         12.2  XMODEM Family Protocols
  1031.  
  1032.         12.2.1  TRUE YMODEM(TM)  Developed in 1981, YMODEM extensions to
  1033.         XMODEM are finding their way into many communications programs.  Rb
  1034.         and sb programs are available for Unix and VAX/VMS.  With Omen's
  1035.         Enhanced Data Recovery(TM), YMODEM gives excellent efficiency,
  1036.         integrity, and good robustness in many applications.
  1037.  
  1038.         True YMODEM transfers one or more files in a batch without alteration
  1039.         or added garbage characters.  True YMODEM preserves the file date
  1040.         across multiple time zones.  ZCOMM and the Unix(TM) rb and sb programs
  1041.         and ZCOMM preserve the file modification date.[3]
  1042.  
  1043.  
  1044.         12.2.2  YMODEM-1k  The sb k option (1024 byte blocks) may be used to
  1045.         enhance throughput, especially when using timesharing systems,
  1046.         satellite links, or packet networks that can support the longer
  1047.         blocks.
  1048.  
  1049.  
  1050.         EXAMPLE: sb -k *.c *.h sends all .c and .h files in the current
  1051.         directory with 1024 byte blocks.[4]
  1052.  
  1053.         YMODEM and YMODEM-1k transfers can be received with the rb or F3
  1054.         commands.
  1055.  
  1056.         YMODEM file transfers with Unix and VMS systems are discussed later in
  1057.         this chapter.
  1058.  
  1059.         A few obsolete programs claiming to support YMODEM actually use XMODEM
  1060.         with 1024 byte blocks; use ZCOMM's sx -k and rx XMODEM commands with
  1061.         these non conforming products.
  1062.  
  1063.         12.2.3  YMODEM with OverThruster  YMODEM and YMODEM-1k file
  1064.         downloading from networks and timesharing systems is slowed by
  1065.         response times.  This slowing may be significant even when 1k blocks
  1066.  
  1067.  
  1068.         __________
  1069.  
  1070.          2. For example, Disk Full or NUKE
  1071.  
  1072.          3. Controlled by the d and z numeric parameters
  1073.  
  1074.          4. ZCOMM switches to 128 byte blocks at the end of a file when the
  1075.             length warrants.
  1076.  
  1077.  
  1078.  
  1079.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1080.  
  1081.  
  1082.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1083.         ZCOMM User Manual                                                   49
  1084.  
  1085.  
  1086.         are used.  With some systems, one can speed up YMODEM downloads by
  1087.         using the o option with the rb command to receive the file.  Because
  1088.         OverThruster(TM) defeats error recovery, a line hit will usually abort
  1089.         a download.  OverThruster(TM) may be used with X.PC or MNP error
  1090.         correcting link level protocols.
  1091.  
  1092.         EXAMPLE: rb -o
  1093.  
  1094.  
  1095.         SEE ALSO: O numeric parameter
  1096.  
  1097.         12.2.4  XMODEM-1k  The XMODEM-1k protocol transfers one file per
  1098.         command with 1024 byte blocks and a nominal 16 bit CRC.  The file name
  1099.         must be entered for both the sender and the receiver.  Programs
  1100.         lacking ZCOMM's Cybernetic Data Recovery(TM) logic are less likely to
  1101.         transfer data accurately under marginal conditions.  XMODEM's use of
  1102.         every possible 8 bit code limit its effectiveness in many
  1103.         applications.
  1104.  
  1105.         The end of the file may be padded by up to 127 or 1023[5] garbage
  1106.         characters.
  1107.  
  1108.         To send a file with XMODEM-1k: sx -k file1
  1109.  
  1110.         To receive a file with XMODEM-1k: rc file1
  1111.  
  1112.         12.2.5  XMODEM-CRC (with fallback)  The XMODEM-CRC protocol transfers
  1113.         one file per command.  The XMODEM-CRC protocol requires the receiving
  1114.         program to initiate an XMODEM-CRC transfer.
  1115.  
  1116.         The file name must be entered for both the sender and the receiver.
  1117.         Even with CRC-16, programs lacking ZCOMM's Cybernetic Data
  1118.         Recovery(TM) are less likely to transfer data under marginal
  1119.         conditions.  XMODEM-CRC's short data blocks and use of every possible
  1120.         8 bit code limit its effectiveness in many applications.
  1121.  
  1122.         The end of the file may be padded by up to 127 garbage characters.
  1123.  
  1124.         To send a file with XMODEM (or XMODEM-CRC): sx file1
  1125.  
  1126.         To receive a file with XMODEM-CRC: rc file1
  1127.  
  1128.         12.2.6  Classic XMODEM  The original MODEM protocol, developed by Ward
  1129.         Christensen, is supported by a large and growing number of programs
  1130.         operating on a variety of micros and minis.  The base level XMODEM
  1131.  
  1132.  
  1133.         __________
  1134.  
  1135.          5. Some programs (including ZCOMM) limit this padding to 127 bytes.
  1136.  
  1137.  
  1138.  
  1139.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1140.  
  1141.  
  1142.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1143.         ZCOMM User Manual                                                   50
  1144.  
  1145.  
  1146.         protocol gives good results when used over low error rate direct
  1147.         telephone connections.  XMODEM's short data blocks and use of every
  1148.         possible 8 bit code preclude its application in many environments.
  1149.  
  1150.         File transfers with this protocol add up to 127 garbage characters to
  1151.         transferred files.  The XMODEM protocol can transfer one file per
  1152.         command.  The file name must be entered at both the sender and the
  1153.         receiver.
  1154.  
  1155.         To send a file with XMODEM: sx file1
  1156.  
  1157.         To receive a file with Classic XMODEM: rx file1
  1158.  
  1159.         12.2.7  Relaxed XMODEM  ZCOMM's XMODEM and YMODEM support has been
  1160.         optimized for maximum reliability with a wide variety of systems under
  1161.         a wide variety of conditions.
  1162.  
  1163.         The default XMODEM and YMODEM timeout limits approach typical
  1164.         "relaxed" timings and rarely need to be lengthened except under the
  1165.         most sluggish of conditions.  The zmodem t, T, and p numeric
  1166.         parameters (q.v.) control timeouts for XMODEM, YMODEM, and ZMODEM.
  1167.         The default values allow 10 seconds for a packet to appear and a
  1168.         maximum 5 second pause within a packet before starting error recovery.
  1169.  
  1170.         EXAMPLE:      zmodem pt200 pp150  :: Set more relaxed X/Y/ZMODEM
  1171.         timing
  1172.  
  1173.  
  1174.         Omen Technology does not recommend tightening these timings for XMODEM
  1175.         and YMODEM transfers on noisy lines.
  1176.  
  1177.         12.2.8  XMODEM with OverThruster  XMODEM file downloading from
  1178.         networks and timesharing systems is slowed by short blocks and long
  1179.         response times.  With some systems, one can speed up downloads by
  1180.         using the ro command to receive the file.  Because OverThruster(TM)
  1181.         defeats error recovery, a line hit will usually abort a download.
  1182.         With nearly error free connections, one can save enough time from the
  1183.         increased throughput to make up for the failed transfers.
  1184.         OverThruster(TM) may be used with X.PC or MNP error correcting link
  1185.         level protocols.
  1186.  
  1187.         EXAMPLE: ro file1
  1188.  
  1189.  
  1190.         EXAMPLE: rb -o
  1191.  
  1192.  
  1193.         SEE ALSO: O numeric parameter
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1200.  
  1201.  
  1202.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1203.         ZCOMM User Manual                                                   51
  1204.  
  1205.  
  1206.         12.2.9  YMODEM-g: Traditional Overdrive  The proliferation of error
  1207.         correcting modems has sparked a proliferation of YMODEM-g programs,
  1208.         more and more of which actually meet minimal YMODEM protocol
  1209.         specifications.
  1210.  
  1211.         YMODEM-g transmits 0 or more files per batch with an ACK-less variant
  1212.         of YMODEM-1k.  The sender does not wait for individual data blocks to
  1213.         be acknowledged, allowing high speed transfers with error correcting
  1214.         modems.
  1215.  
  1216.         YMODEM-g assumes an error free communications channel.  A single
  1217.         transmission error or character lost because of DOS or TSR interrupt
  1218.         latency ruins the entire transfer, and YMODEM-g does not support Crash
  1219.         Recovery(TM).
  1220.  
  1221.         ZCOMM supports True YMODEM-g with the sb and rb -g commands.
  1222.  
  1223.         EXAMPLE: sb *.old Sends files in the current directory with YMODEM or
  1224.         YMODEM-g protocol.  The receiver controls whether YMODEM or YMODEM-g
  1225.         is used for the transfer.
  1226.  
  1227.  
  1228.         EXAMPLE: rb -g Receives with YMODEM-g protocol.
  1229.  
  1230.  
  1231.         12.2.10  XMODEM Mutants Misrepresented as YMODEM  Despite continuing
  1232.         education efforts, a few lazy software providers insist on identifying
  1233.         their mutant XMODEM protocols as "ymodem".  They choose to ignore the
  1234.         definition of YMODEM that Ward Christensen wrote when he coined the
  1235.         term YMODEM in his April 1985 message:
  1236.  
  1237.            (a) a record 0 containing filename date time and size
  1238.            (b) a 1K block size option
  1239.            (c) CRC-16.
  1240.  
  1241.         In case of questions, please refer to ymodem.doc, part of yzmodem.zoo
  1242.         (yzmodem.arc) for for the official YMODEM protocol.
  1243.  
  1244.         12.2.11  Qmodem-G/Streaming XMODEM  The Qmodem program and certain
  1245.         bulletin boards provide an ACKless XMODEM mutant protocol selected
  1246.         with the Qmodem G protocol menu choice.
  1247.  
  1248.         The sx and rx -g commands support this mutant XMODEM.
  1249.  
  1250.         EXAMPLE: rx -g qmodem.fil
  1251.  
  1252.  
  1253.         12.2.12  WXMODEM (People-Link)  ZCOMM supports WXMODEM protocol
  1254.         downloads with the rw command.  On the People-Link timesharing
  1255.         service, WXMODEM downloads are faster than XMODEM downloads.
  1256.         Throughput, reliability, accuracy, and amenities are not as good as
  1257.  
  1258.  
  1259.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1260.  
  1261.  
  1262.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1263.         ZCOMM User Manual                                                   52
  1264.  
  1265.  
  1266.         ZMODEM or SuperKermit, but neither of these protocols are currently
  1267.         available on that system.  WXMODEM adds up to 127 garbage bytes to
  1268.         transferred files.  Omen Technology does not recommend WXMODEM for use
  1269.         over noisy phone lines.
  1270.  
  1271.         EXAMPLE: rw file1
  1272.  
  1273.  
  1274.         12.2.13  MODEM7 Batch  The MODEM7 batch protocol passes CP/M file
  1275.         names from the sending program to the receiver one character at a
  1276.         time.  The compatibility, throughput, and reliability problems of this
  1277.         kluge prompted the development of YMODEM.  Nonetheless, when it
  1278.         becomes necessary to transfer files with a program lacking more
  1279.         advanced protocols, MODEM7 batch is better than nothing.
  1280.  
  1281.         File names transmitted with the MODEM7 batch protocol must obey the
  1282.         restrictions of both 8 bit CP/M and DOS.  The f option cannot be used
  1283.         with MODEM7 batch.  Data transfer within MODEM7 batch uses XMODEM
  1284.         protocol, and all of XMODEM's weaknesses discussed above apply to
  1285.         MODEM7 batch.  MODEM7 batch does not preserve the modification date or
  1286.         exact file contents.
  1287.  
  1288.         EXAMPLE: s7 file1.ext *.baz sends files with MODEM7 batch.
  1289.  
  1290.  
  1291.         EXAMPLE: r7 receives one or more files with MODEM7 batch.
  1292.  
  1293.  
  1294.         12.2.14  Telink/FIDO  The Telink protocol expands upon the MODEM7
  1295.         batch kluge with a specially formatted block containing the length of
  1296.         the file and the local DOS time and date.  The length data allows the
  1297.         receiver to truncate the file length to that the original file.  All
  1298.         of the MODEM7 batch compatibility and reliability problems apply to
  1299.         Telink.[6] The zmodem Z numeric parameter or the z file transfer
  1300.         option may be used to correct the time/date stamping of files
  1301.         transferred between different time zones.
  1302.  
  1303.         EXAMPLE: zmodem pZ120;  st file1.ext *.baz Sends the specified files
  1304.         with a 2 hour time zone adjustment.
  1305.  
  1306.  
  1307.         EXAMPLE: rt -z60 Receives one or more files with a 60 minute time zone
  1308.         adjustment.
  1309.  
  1310.  
  1311.         __________
  1312.  
  1313.          6. ZCOMM's rt and st commands were verified with Minitel 3.0 by Tom
  1314.             Jenning's Fido Software; other Programs may not produce the same
  1315.             results.
  1316.  
  1317.  
  1318.  
  1319.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1320.  
  1321.  
  1322.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1323.         ZCOMM User Manual                                                   53
  1324.  
  1325.  
  1326.         12.2.15  SEAlink  When transferring files with the CLINK 1.13
  1327.         compatible programs, ZCOMM's rb and sb commands recognize SEAlink's
  1328.         modified Telink protocol.  The rb command allows a transmitting
  1329.         SEAlink program to use sliding windows.  Telink time zone and file
  1330.         name considerations apply to SEAlink.  In addition, because SEAlink
  1331.         uses all 256 of the possible 8 bit codes for both data transfer and
  1332.         protocol management, some modems and networks that operate with XMODEM
  1333.         will not accommodate SEAlink.  As with the MODEM7 and Clink protocols
  1334.         mentioned above, the SEAlink protocol is included for convenience in
  1335.         situations where the YMODEM and ZMODEM protocols are not
  1336.         implemented.[7]
  1337.  
  1338.         EXAMPLE: zmodem pZ120;  sb file1.ext *.baz Sends the specified files
  1339.         to a SEAlink program with a 2 hour time zone adjustment.
  1340.  
  1341.  
  1342.         EXAMPLE: rb -z60 Receives one or more files from a SEAlink program
  1343.         with a 60 minute time zone adjustment.
  1344.  
  1345.  
  1346.         12.3  Kermit
  1347.  
  1348.         Kermit operates with a wide range of computer systems, including those
  1349.         whose restrictive terminal interfaces prevent XMODEM transfers.
  1350.         Kermit uses an encoding technique called quoting to represent control
  1351.         characters and (if necessary) parity bits with standard printable
  1352.         characters.  It is one of the few asynchronous error correcting
  1353.         protocols that work properly with half duplex IBM front ends.  Because
  1354.         of the overhead from character quoting, Kermit is less efficient
  1355.         (slower) than the ZMODEM.
  1356.  
  1357.         Kermit can transfer one or more files per command, preserving the
  1358.         exact file length.  The popular timesharing service The Source
  1359.         supports the Kermit file transfer protocol in ASCII and binary modes.
  1360.  
  1361.         Kermit was developed at Columbia University.  The protocol and
  1362.         supporting mainframe programs are described in documents available
  1363.         from Columbia University and elsewhere.
  1364.  
  1365.         12.3.1  Incompatible Kermit Dialects  When sending files with the
  1366.         Kermit Protocol, ZCOMM uses all 8 bits for the transfer unless a 7 bit
  1367.         parity mode (e.g., ena -7e) is used, the kermit 7 numeric parameter is
  1368.  
  1369.  
  1370.         __________
  1371.  
  1372.          7. ZCOMM's SEAlink was verified with CLINK 1.13 by Systems
  1373.             Enhancement Associates.  Other Programs may not produce the same
  1374.             results because of ambiguities in the SEAlink documentation and
  1375.             undocumented protocol variants.
  1376.  
  1377.  
  1378.  
  1379.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1380.  
  1381.  
  1382.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1383.         ZCOMM User Manual                                                   54
  1384.  
  1385.  
  1386.         non zero, or the other program requests 8th bit qouting.  If ZCOMM is
  1387.         using a 7 bit parity mode (such as ena -7m), ZCOMM requests 8th bit
  1388.         quoting unless the kermit 8 numeric parameter is non zero.
  1389.  
  1390.         -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  1391.                         Both programs must use the same parity
  1392.                         for Kermit file transfers to succeed.
  1393.         -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  1394.  
  1395.         Kermit does not provide an automatic means of forcing both the sender
  1396.         and receiver to use the same dialect.  Files cannot be transferred if
  1397.         the two programs disagree on parity handling, Such failures are quite
  1398.         commonplace.  A common symptom is a transfer that starts up normally
  1399.         but always fails at the same block.  Setting appropriate parity
  1400.         corrects these Kermit failures.
  1401.  
  1402.         ZCOMM's Kermit AutoDownload(TM) (enabled with the K mode) allows the
  1403.         term function to sense the beginning of a Kermit file download, make
  1404.         the proper determination on whether to use 8 bit serial data, and
  1405.         execute the file download without user intervention.
  1406.  
  1407.         12.3.2  Kermit Performance Enhancements  Super-Kermit (Kermit with
  1408.         Sliding Windows) transmits up to 31 packets before waiting for a
  1409.         response, increasing throughput with timesharing systems and networks.
  1410.         ZCOMM uses sliding windows and CRC error detection if the other
  1411.         machine's Kermit supports them.
  1412.  
  1413.         ZCOMM also supports long packets for increased throughput with
  1414.         suitable systems, including many that do not support sliding windows.
  1415.         ZCOMM allows Kermit long packets up to 1000 characters on DOS, up to
  1416.         2048 on 32 bit Unix systems.
  1417.  
  1418.         The maximum send packet length is set by the kermit l numeric
  1419.         parameter.  ZCOMM will ask for sliding windows if this is set to 94 or
  1420.         less.
  1421.  
  1422.         EXAMPLE: k pl94
  1423.  
  1424.  
  1425.         The maximum receive packet length is set by the kermit L numeric
  1426.         parameter.  ZCOMM will ask for sliding windows if this is set to 94 or
  1427.         less.
  1428.  
  1429.         EXAMPLE: k pL94
  1430.  
  1431.  
  1432.         With the default values for the kermit l and kermit L parameters,
  1433.         ZCOMM will choose long packets over sliding windows when a choice is
  1434.         possible.
  1435.  
  1436.         ZCOMM supports 12 bit Kermit checksums and 16 bit Kermit CRC for
  1437.  
  1438.  
  1439.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1440.  
  1441.  
  1442.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1443.         ZCOMM User Manual                                                   55
  1444.  
  1445.  
  1446.         professional error detection performance.  ZCOMM uses the most
  1447.         reliable Kermit error correction available.  Shorter checksums may be
  1448.         forced by changing the kermit b numeric parameter.
  1449.  
  1450.         EXAMPLE: kermit sb file1 file2
  1451.  
  1452.  
  1453.         EXAMPLE: kermit rb
  1454.  
  1455.  
  1456.         12.3.3  ZCOMM Kermit Capabilities At a Glance
  1457.          Local operation..................Yes
  1458.          Remote operation.................Yes
  1459.          Transfers text files.............Yes
  1460.          Transfers binary files...........Yes
  1461.          Wildcard send....................Yes
  1462.          Filename collision avoidance.....Yes
  1463.          Can time out.....................Yes
  1464.          8th-bit prefixing................Yes
  1465.          8 bit serial data................Yes
  1466.          Sliding Windows..................Yes
  1467.          Long Packets.....................Yes
  1468.          Repeat count prefixing...........Yes
  1469.          Alternate block checks...........Yes
  1470.          Terminal emulation...............Multiple
  1471.          Communication settings...........Yes
  1472.          Transmit BREAK...................Yes
  1473.          IBM mainframe communication......Yes
  1474.          Transaction logging..............Yes
  1475.          Act as server....................no
  1476.          Talk to server...................Yes
  1477.          Advanced commands for servers....Yes
  1478.          Handle file attributes...........no
  1479.          Programmable reset string........Yes
  1480.  
  1481.         12.3.4  Accessing Kermit Servers  The commands to start up a Kermit
  1482.         server vary from system to system.  Unix C-Kermit can be started in
  1483.         server mode with kermit -ix given to Unix or VMS.  When the Kermit
  1484.         server is active, the ZCOMM get, send, and remote ...  commands may be
  1485.         used.  The ZCOMM finish command causes the remote Kermit server to
  1486.         exit to its operating system.
  1487.  
  1488.         12.3.5  Kermit Caveats  If the Kermit protocol doesn't work with IBM
  1489.         mainframe communications, incorrect ASCII/EBCDIC translate tables may
  1490.         be the problem.
  1491.  
  1492.         Some mainframe "front ends" require special characters or a break
  1493.         signal to recover from transmission errors ("line hits").  The
  1494.         kermreset string parameter (q.v.) may be programmed with the required
  1495.         sequence.
  1496.  
  1497.  
  1498.  
  1499.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1500.  
  1501.  
  1502.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1503.         ZCOMM User Manual                                                   56
  1504.  
  1505.  
  1506.         SEE ALSO: kermreset string parameter
  1507.  
  1508.         Some versions of Kermit translate files as they are sent.  Typical
  1509.         modifications include CR/LF to NL transformations and CPMEOF
  1510.         stripping.  When transferring binary files, such editing must be
  1511.         disabled with SET FILE TYPE BINARY or similar commands given to the
  1512.         other program.  The demonstration in Chapter 9 includes several Kermit
  1513.         server access and file transfer commands.
  1514.  
  1515.         When downloading files from some versions of Kermit, best results may
  1516.         sometimes be obtained by starting ZCOMM's kermit receive before typing
  1517.         the carriage return that starts the sender on the remote.  If the
  1518.         other program includes an adjustable initial delay, you can save time
  1519.         by setting it to zero.
  1520.  
  1521.         SEE ALSO: kermit d numeric parameter
  1522.  
  1523.         SEE ALSO: K mode (Kermit AutoDownload(TM))
  1524.  
  1525.         12.4  Uploading Files to Remote Unix Systems
  1526.  
  1527.         On Unix(TM) systems, files may be uploaded most conveniently and
  1528.         efficiently with the ZMODEM protocol supported by the Unix rz program.
  1529.         The rz program supports a subset of ZCOMM's ZMODEM features; see the
  1530.         rz program's manual page for more information.
  1531.  
  1532.         If rz is not installed on the Unix system, unpack the rzsz.zoo file[8]
  1533.         with: looz -e rzsz.zoo given from the DOS prompt.[9] Next, the command
  1534.         source zupl.t calls the zupl.t script to upload the bootstrap file
  1535.         minirb.c, compile it, and use it to upload the remainder of the source
  1536.         files.
  1537.  
  1538.         After the rest of the files have been uploaded, compile rz.c and sz.c
  1539.         using the directions given in the README file and in the C source
  1540.         files.
  1541.  
  1542.         The manual "pages" rz.1 and sz.1 may be formatted with nroff commands
  1543.         such as
  1544.  
  1545.              nroff -Tlp -man rz.1 sz.1
  1546.  
  1547.         Versions of sq, type, usq, and zoo are available for Unix.  The Unix
  1548.  
  1549.  
  1550.         __________
  1551.  
  1552.          8. This file is part of the DSZ and Professional-YAM distributions.
  1553.  
  1554.          9. The rzsz.zoo or rzsz.arc file is also available on TeleGodzilla
  1555.             and other bulletin boards.
  1556.  
  1557.  
  1558.  
  1559.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1560.  
  1561.  
  1562.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1563.         ZCOMM User Manual                                                   57
  1564.  
  1565.  
  1566.         version of USQ has a -n flag to strip carriage returns.  In addition,
  1567.         the undos program may be used to remove carriage returns from Unix
  1568.         files.
  1569.  
  1570.         12.5  Downloading Files from Remote Unix Systems
  1571.  
  1572.         To download files from Unix(TM) systems, simply use the Unix sz
  1573.         program to send the desired files to ZCOMM.  To Unix keyboard:
  1574.         sz file ...  ZCOMM's ZMODEM AutoDownload(TM) takes care of the rest
  1575.         for you, saving unnecessary keystrokes.
  1576.  
  1577.         If one or more of the files already exists on the destination disk,
  1578.         use sz -y file ...  instead, to replace the old copies on your
  1579.         computer.
  1580.  
  1581.         Another useful option sends only the files that exist on both
  1582.         computers (Y), and furthermore sends only those that are newer (n):
  1583.         sz -Yn file ...
  1584.  
  1585.         When files are long and transmission slow, you can save time by
  1586.         squeezing them first with sq.  Source for a Unix compatible version of
  1587.         sq is available in xsq.cq.  The zoo program, available for DOS and
  1588.         Unix, may also be used to compress file(s) before transmission.
  1589.  
  1590.         Omen Technology products support ZMODEM compression with the Z option.
  1591.         All Omen Technology products support compression by Run Length
  1592.         Encoding (RLE).  Unix flavors of Professional-YAM also support LZW
  1593.         compression.
  1594.  
  1595.         Unix source files normally do not contain carriage returns used by
  1596.         CP/M and DOS.  Some CP/M or DOS programs, such as C compilers, do not
  1597.         require carriage returns in the source files.  Others, such as the
  1598.         Microsoft Macro Assembler, become quite confused by such files,
  1599.         although such files fully meet the requirements of the ASCII standard.
  1600.  
  1601.         Carriage Returns may be added before downloading with the todos or
  1602.         tocpm programs.  Carriage returns may be added during the transfer
  1603.         with the sz a option.  Carriage Returns may be added after the
  1604.         transfer by some program editors, including uEMACS.  (Other editors,
  1605.         such as DOS edlin may crash trying to edit such files.) Short files
  1606.         (less than 28kb) may be converted using ZCOMM's read and create
  1607.         commands to pass the data through ZCOMM's capture buffer.
  1608.  
  1609.         Text files may also be downloaded using the capture buffer if sz has
  1610.         not been installed on the Unix machine.
  1611.  
  1612.         If a file or set of files are to be transported between two Unix
  1613.         systems, it may be helpful to place them in a tar or cpio archive (and
  1614.         possibly squeeze the archive) before transmission.  This procedure
  1615.         will preserve the Unix file modes and modification times, and bypass
  1616.         pathname restrictions imposed by DOS.
  1617.  
  1618.  
  1619.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1620.  
  1621.  
  1622.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1623.         ZCOMM User Manual                                                   58
  1624.  
  1625.  
  1626.         12.6  VMS File Transfers
  1627.  
  1628.         The abovementioned rz and sz sources also compile on the DEC VMS C
  1629.         compiler.  Instructions for compiling, linking, and installing the
  1630.         programs are contained in the rz.c and sz.c source files.
  1631.  
  1632.         Most of the comments made above about Unix file transfers apply to VMS
  1633.         as well.
  1634.  
  1635.         The command source vupl.t calls the vupl.t script to upload the files
  1636.         needed to compile the programs on VMS.  The script attempts to invoke
  1637.         a Kermit server and use Kermit to upload the files.  If no Kermit
  1638.         server is found, the script uses the DCL create command to upload the
  1639.         files by emulating a paper tape reader.
  1640.  
  1641.         Make certain to "install" the VMS sz command to the DCL interpreter.
  1642.  
  1643.         12.7  CompuServe File Transfers
  1644.  
  1645.         ZCOMM supports CompuServe Quick-B and the faster Extended Quick-B (B+)
  1646.         file transfer protocols.
  1647.  
  1648.         As this is being written, these protocols are being revised.  Please
  1649.         check the newest.me file for possible changes.
  1650.  
  1651.         B Protocol is used by the CompuServe Timesharing Service through the
  1652.         CompuServe, Tymnet, and Telenet networks.  B Protocol file transfers
  1653.         are initiated by the CompuServe computer.  The B Protocol file
  1654.         transfer protocol is well supported by this timesharing service.
  1655.         Under typical conditions, the B Protocol saves 35 per cent or more in
  1656.         file transmission time and connect charges compared to XMODEM protocol
  1657.         transfers.
  1658.  
  1659.         The c or C mode must be set with ena -c or ena -C to allow the B
  1660.         protocol to seize control and transfer files.
  1661.  
  1662.         The adlopts string parameter allows the y and v file transfer options
  1663.         to be specified for CIS-B transfers.
  1664.  
  1665.         The w numeric parameter controls the block length used by the
  1666.         CompuServe B Protocol.  A longer length increases throughput, but may
  1667.         overload some networks, resulting in excessive retransmissions or
  1668.         failed transfers.  With the new Extended Quick-B protocol, the maximum
  1669.         block length is 1024 data bytes.  A value of 0 (the default) allows
  1670.         the Compuserve computer to control the block length, up to 1024 with
  1671.         Extended Quick-B.
  1672.  
  1673.         A negative value controls the upload block length but still allows
  1674.         Compuserve to control the download block length (1024 with Extended
  1675.         Quick B).
  1676.  
  1677.  
  1678.  
  1679.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1680.  
  1681.  
  1682.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1683.         ZCOMM User Manual                                                   59
  1684.  
  1685.  
  1686.         Uploads to Compuserve using longer block lengths are especially
  1687.         sensitive to poor flow control, especially when error correcting
  1688.         modems (MNP, etc.) are used.  If B protocol uploads fail or require
  1689.         excessive retransmissions, correct the flow control arrangements,
  1690.         disable the modem's error correction, or try a smaller upload block
  1691.         size.
  1692.  
  1693.         The data contents of successfully transferred file(s) are not affected
  1694.         by this parameter.
  1695.  
  1696.         Some networks may garble data when Quick-B's streaming causes ZCOMM to
  1697.         respond to incoming data concurrently with incoming data.  The o
  1698.         numeric parameter can be set to 0 to disable streaming (send-ahead).
  1699.  
  1700.         It is essential to use the same interface speed to the modem as the
  1701.         modem's transmission rate when uploading files with B protocol.  If
  1702.         the modem buffers any characters, ZCOMM's response to CompuServe's
  1703.         flow control will be too slow to prevent loss of data.
  1704.  
  1705.         The CompuServe B Protocol controls all file transfer operations
  1706.         (except permission to overwrite files) from the timesharing system.
  1707.  
  1708.         Waiting for long files to download can be boring.  You can start the
  1709.         transfer and walk away from the computer, but CompuServe will stay
  1710.         connected for 15 minute$ after the transfer is finished if you don't
  1711.         come back when the download finishes.  This expense can be avoided by
  1712.         typing ALT-Q once the protocol transfer has started.  ALT-Q tells
  1713.         ZCOMM to disconnect as soon as the protocol transfer is completed,
  1714.         stopping the connect charges.  An alternative method is to control the
  1715.         transfers with a script, using either ejryam or the less sophisticated
  1716.         cissig and dow.t scripts included with the software distribution.
  1717.  
  1718.         When "browsing" through CompuServe's software "downloading section"
  1719.         libraries, the kcisdl.t script file and ZCOMM allow you to download a
  1720.         file with a single keystroke: F3.  Installation instructions are
  1721.         provided in that file.
  1722.  
  1723.  
  1724.         12.8  BIX File Transfers
  1725.  
  1726.         BIX (Byte Information Exchange) supports ZMODEM, YMODEM, XMODEM-1k,
  1727.         and Kermit file transfers.
  1728.  
  1729.         The Tymnet phone number in the bix telephone directory entry should be
  1730.         changed for your calling area.  Other scripts are provided to handle
  1731.         BIX mail and conferences.
  1732.  
  1733.         When setting up a new BIX account, give the command call bix,new to
  1734.         force a login to the BIX new account program.
  1735.  
  1736.         Use "join listings" to get the current, properly functioning version
  1737.  
  1738.  
  1739.         (C) 1988 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1740.  
  1741.  
  1742.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1743.         ZCOMM User Manual                                                   60
  1744.  
  1745.  
  1746.         of the BIX file transfer software.  Be sure to select ZMODEM downloads
  1747.         and Kermit (sliding windows) uploads with the "OPTIONS" menu choice.
  1748.         Their transfer time predictions are about 40 per cent too pessimistic
  1749.         for ZMODEM transfers.
  1750.  
  1751.         12.9  User Exit Processing
  1752.  
  1753.         User exits are available for additional processing after each file is
  1754.         transferred.
  1755.  
  1756.         The oncloserx string parameter may be used to perform user commands or
  1757.         call a script once for each file received with a file transfer
  1758.         protocol.
  1759.  
  1760.         EXAMPLE: set oncloserx "@crc %rname; !%mv %rname /tmp"
  1761.         When each file is received, the crc command calculates and displays a
  1762.         CRC for the file, and the !% command calls the mv program to move the
  1763.         file just received to the /tmp directory.
  1764.  
  1765.  
  1766.         The onclosetx string parameter may be used to perform user commands or
  1767.         call a script once for each file sent with a file transfer protocol.
  1768.         Wild card file name expansions may not be used.
  1769.  
  1770.         EXAMPLE: The following causes each successfully sent file to be moved
  1771.         to the /done directory.
  1772.              set onclosetx
  1773.         @if !d? !%mv %rname /done
  1774.  
  1775.  
  1776.         SEE ALSO: rname, tname, drive, pwd string parameters, ?, d?  test
  1777.         conditions
  1778.  
  1779.         NOTE: User exits may cause protocol timeouts if their execution takes
  1780.         too long.
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.         (C) 1988 Omen Tech Inc                    Chapter 12 Message Transfers
  1800.  
  1801.